home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / os2 / afe22.arj / AFE.DOC < prev    next >
Text File  |  1994-01-15  |  49KB  |  1,025 lines
  1.      
  2.      
  3.     15 January 1994               Contents                  AFE Version 2.2
  4.     -----------------------------------------------------------------------
  5.     AFE - Archive Front End, a Cheap(!) native OS/2 2.1 VX-REXX program
  6.     which provides a visual front end for the handling of ZIP, LZH, ZOO
  7.     and ARJ files.
  8.      
  9.      Contents                                      Page
  10.      --------------------------------------------------
  11.        i. Background  . . . . . . . . . . . . . . . 1
  12.      
  13.        ii. Registration Plea  . . . . . . . . . . . 1
  14.      
  15.        iii. Included Files in the AFE Package . . . 2
  16.      
  17.        A. Program Features  . . . . . . . . . . . . 2
  18.      
  19.        B. Assumptions . . . . . . . . . . . . . . . 3
  20.      
  21.        C. Installation  . . . . . . . . . . . . . . 4
  22.      
  23.        D. Notes on Running the Program  . . . . . . 5
  24.      
  25.              1. Main Menu . . . . . . . . . . . . . 5
  26.      
  27.              2. Archive Submenu . . . . . . . . . . 5
  28.      
  29.              3. File Selection Window . . . . . . . 6
  30.      
  31.              4. Creating a New Archive  . . . . . . 6
  32.      
  33.              5. Updating and Existing Archive . . . 7
  34.      
  35.              6. UnArchive . . . . . . . . . . . . . 7
  36.      
  37.              7. View or Print . . . . . . . . . . . 8
  38.      
  39.              8. V-Scan  . . . . . . . . . . . . . . 8
  40.      
  41.              9. M/V-Scan  . . . . . . . . . . . . . 9
  42.      
  43.              10. Exiting AFE  . . . . . . . . . . . 10
  44.      
  45.              11. Configure  . . . . . . . . . . . . 10
  46.      
  47.              12. Internal Archive Detection . . . . 10
  48.      
  49.              13. Archive Errors . . . . . . . . . . 11
  50.      
  51.              14. TryAll Subroutine  . . . . . . . . 11
  52.      
  53.              15. Variable Errors  . . . . . . . . . 11
  54.      
  55.              16. Miscellaneous Tips . . . . . . . . 12
  56.      
  57.        E. Cautions and Limitations  . . . . . . . . 13
  58.      
  59.        F. Contacting the Author . . . . . . . . . . 14
  60.      
  61.        G. Copyright Notices and Disclaimer  . . . . 15
  62.      
  63.        H. What's New (AFE History)  . . . . . . . . 16
  64.      
  65.     15 January 1994                 Page 1                  AFE Version 2.2
  66.     -----------------------------------------------------------------------
  67.      
  68.     i. Background
  69.      
  70.     AFE started out as a personal project to fill my need for a native OS/2
  71.     front-end for archive manipulation, and at the same time, give
  72.     me some particular goal while learning to use REXX.
  73.      
  74.     After many hours of effort, I came up with AFE 1.1, which utilized
  75.     IBM's in-house developed VREXX for the PM graphics.  I realized that
  76.     other OS/2ers might be interested in this type of front-end, since what
  77.     was available at the time in this catagory was very limited, so
  78.     I posted my work as Freeware on two local BBSes that I frequented.
  79.      
  80.     Unfortunately, VREXX imposes some severe limitions in many respects, so
  81.     I decided to give it a shot using Watcom's VX-REXX.  After
  82.     building some less complex projects with VX-REXX to understand its
  83.     capabilities, it was time to tackle a new and improved version of the
  84.     "Archive Front End".  This package is the result.
  85.      
  86.     While AFE wouldn't be a totally new concept in the DOS world, the
  87.     choice of OS/2 native programs that handle most popular  archive
  88.     formats, facilitate selective unarchiving, virus scanning, viewing or
  89.     printing of internal files, creating new archives, and updating
  90.     existing archives is very limited.
  91.      
  92.     Please pass AFE on to other BBSes, including all files in this archive.
  93.      
  94.      
  95.      
  96.     ii. Registration
  97.      
  98.     I have many, many hours of work invested in developing and testing AFE.
  99.     What you have here is the complete package, whether you register or
  100.     not.  I detest crippleware and shareware reminder notices, so you won't
  101.     find any of that here.
  102.      
  103.     What registration will buy you is this: I'll entertain your suggestions
  104.     for enhancements, I'll be inspired to continue to make improvements, I
  105.     won't grow more tolerant of shareware reminder notices, I'll be
  106.     grateful to you, and most of all, I'll confirm my notion that OS/2ers
  107.     are more honorable than DOS/Windows users.
  108.      
  109.     I've set the price at a low $19.50 for the individual user.  I'm not
  110.     trying to retire on shareware income, but it would be nice to be able
  111.     to pay for development environment and the phone bill for posting it
  112.     here and there.
  113.      
  114.     AFE is a copyrighted program.  It is not public domain or free
  115.     software.  A limited license is granted for the purpose of determining
  116.     suitability of the program.  Registration is required for any use
  117.     beyond a 15 day evaluation period.  Registered user have the right to
  118.     use this program for their personal use on one or more computers
  119.     provided that only 1 copy is in use at the same time.
  120.      
  121.     After a couple of weeks of using AFE, you ought to know if it's the
  122.     archive tool for you.  Fill out and print REG-FORM.AFE and make out a
  123.     check.
  124.      
  125.     15 January 1994                 Page 2                  AFE Version 2.2
  126.     -----------------------------------------------------------------------
  127.      
  128.     iii. Included Files in the AFE Package
  129.      
  130.     AFE.EXE - The executable program
  131.  
  132.     AFE.ICO - The icon used to represent AFE on the desktop
  133.      
  134.     AFE.DOC - This documentation file
  135.      
  136.     AFE-INST.EXE - The AFE installation/configuration program
  137.      
  138.     AFE-CFG.EXE - The AFE re-configuration program to change variable
  139.                   settings (must be called from AFE)
  140.      
  141.     README.1ST - An extraction of the installation and cautions/limitations
  142.                  sections from this document
  143.      
  144.     VROBJ.DLL - The VX-REXX library for the PM graphics
  145.      
  146.     REG-FORM.AFE - The registration form/mailer
  147.      
  148.     FILE_ID.DIZ - A BBS description of AFE
  149.      
  150.     OPEN.CMD - A little bonus to make life easier
  151.                (see the documentation within the file)
  152.      
  153.      
  154.      
  155.     A. Program Features
  156.      
  157.        - create or selectively update archives
  158.      
  159.        - view selected files in an archive
  160.      
  161.        - print selected files in an archive
  162.      
  163.        - virus scan an archive
  164.      
  165.        - mark a list of files in a directory for scanning
  166.      
  167.        - unarchive member files selectively or in entirety
  168.      
  169.        - supports Drag 'n Drop or double-click of archive files to start
  170.      
  171.        - detects archives within an archives and allows you to
  172.          selectively unarchive them
  173.      
  174.     15 January 1994                 Page 3                  AFE Version 2.2
  175.     -----------------------------------------------------------------------
  176.      
  177.     B. Assumptions
  178.      
  179.        - REXX support is installed.  See the OS/2 documentation on how
  180.          to use "Selective Install" if you need to add it.
  181.      
  182.        - ZIP.EXE for OS/2 is installed.  This is a Public Domain program,
  183.          currently version 2.0.1, and is available on most BBSes that
  184.          support OS/2.
  185.      
  186.        - UNZIP.EXE for OS/2 is installed.  This is a Public Domain program,
  187.          currently version 5.0p1, and is available on most BBSes that
  188.          support OS/2.
  189.      
  190.        - LH16.EXE or LH32.EXE for OS/2 is installed.  This is a Public
  191.          Domain program, currently version 2.22, and is available on most
  192.          BBSes that support OS/2.
  193.      
  194.        - ZOO.EXE for OS/2, version 2.1 is installed.  This is a Public
  195.          Domain program and is available on most BBSes that support
  196.          OS/2.  Note that you should be using either the 16 bit version
  197.          an .EXE dated 7/14/91 or the 32 bit version dated 10/6/93.
  198.      
  199.          The 32 bit version dated 9/20/92 WILL NOT WORK properly at all
  200.          when called from AFE.
  201.      
  202.        - ARJ.EXE 2.41a (DOS) is installed.  This is a Shareware program by
  203.          Robert K. Jung.  Note that when a OS/2 native mode ARJ creation/
  204.          extraction program becomes available, AFE's support will be
  205.          recoded for that program.
  206.      
  207.        - OS2SCAN.EXE is installed.  This is a Shareware program from McAfee
  208.          Associates, currently version 109, and is available on most BBSes
  209.          that support OS/2, or contact McAfee directly.
  210.      
  211.        - An OS/2 native file viewer is installed.  By default, E.EXE is
  212.          used.  While E is not the worlds greatest editor, it works just
  213.          great as a viewer with AFE, and it's free!  Whatever you decide, a
  214.          PM program will work best with AFE.
  215.      
  216.        - VIEW.EXE is installed.  This is OS/2's viewer for INF files.
  217.      
  218.     Note: any of the external executables may be omitted if you do not
  219.     intend to use the associated capability.  That capability will be
  220.     disabled in AFE.  For example, if you omit support for ZOO type
  221.     archives, then the ZOO button will be disabled on the main menu.  In
  222.     addition, if you were to drag 'n drop a .ZOO file on the program
  223.     object, AFE would greet you with an error message.
  224.      
  225.     Caution #1: If you attempt to open a file which doesn't have an
  226.     extension of ZIP, ZOO, LZH or ARJ, AFE would normally attempt to to
  227.     open that file with all four methods.  If one of the archive types is
  228.     not supported, then AFE can only attempt to open it with the others.
  229.      
  230.     Caution #2: If you elect to not support a file viewer, you also are are
  231.     disabling the capability to view the report output by the virus scanner
  232.     from within AFE if a virus is detected.  You will still be notified
  233.     that a virus was detected, and a file named VSCANRPT.### will be left
  234.     in the directory you designate in the .CFG file as "ARCDIR".
  235.      
  236.     15 January 1994                 Page 4                  AFE Version 2.2
  237.     -----------------------------------------------------------------------
  238.  
  239.     C. Installation
  240.      
  241.     Upgraders from AFE 2.0 or 2.01 should proceed as with a new
  242.     installation since AFE.CFG's layout has changed and VROBJ.DLL must
  243.     be upgraded to the 11/19/93 version.  It should not be necessary to
  244.     pre-erase the old files.
  245.  
  246.        1. UnZIP AFE22.ZIP.  If you're reading this, you've probably
  247.           already done that.
  248.  
  249.        2. Type AFE-INST from the directory where all the unzipped files are
  250.           located.  This program will guide you through setting the
  251.           variables for your system, where to install AFE, where to install
  252.           the .DLL file and create a desktop object for AFE that has the
  253.           proper settings and associations.
  254.      
  255. * Note: OS/2 puts a "." as the first path in your LIBPATH statement in    *
  256. * your CONFIG.SYS file by default.  This tells OS/2 to search the current *
  257. * path for the appropriate .DLL when you try to execute a program.  The   *
  258. * AFE-INST program requires this to work unless you are running it        *
  259. * directly from a directory in your LIBPATH.                              *
  260.      
  261.           The entry fields in the installation program support all the
  262.           normal editing functions supported in the WPS such as destructive
  263.           backspace, overwriting highlighted text, etc.  When you are
  264.           satisfied with your entry, press the "Okay" button (or Enter),
  265.           and you will be stepped to the next variable defining dialog.
  266.      
  267.           If the meanings of the directory variables are not clear to you
  268.           with the explanations in the install program, read the next
  269.           section on running AFE to understand how the the directories are
  270.           used.
  271.  
  272.        3. If everything goes properly, AFE should start when you exit the
  273.           installation program.
  274.      
  275.        4. (Optional) Set the font in "E" to SYSTEM VIO.  This makes
  276.           viewing plain text files easier because of its even spacing.
  277.  
  278.     I have the program object along the bottom of my Desktop since I use it
  279.     everyday.  I use a Shareware File/directory manager that supports drag
  280.     'n drop from its file list which makes it super easy to start AFE by
  281.     highlighting the file name and dragging it to my program icon.  Plus, 
  282.     if I want to run AFE from the main menu, I don't have to dig into a 
  283.     folder to start it.
  284.      
  285.     15 January 1994                 Page 5                  AFE Version 2.2
  286.     -----------------------------------------------------------------------
  287.      
  288.     D. Notes on Running the Program
  289.      
  290.     AFE progresses in logical steps (I hope), and has no online help, as I
  291.     think this would add unnecessary bulk to the program.  Once you start
  292.     using the program, its operation should become apparent.  If not, below
  293.     are some details about using the program.
  294.      
  295.      
  296.        1. Main Menu
  297.      
  298.        When you start the program by double-clicking its desktop object,
  299.        the main menu is displayed.  There are six major choices on the main
  300.        menu represented by the following pushbuttons.
  301.      
  302.           Archive: start the process of building a new archive or updating
  303.           an existing one.
  304.      
  305.           UnArchive: start the process of extracting all or chosen member
  306.           files from an archive.
  307.      
  308.           View: start the process to view an internal text or INF file in
  309.           an archive.
  310.      
  311.           Print: start the process to Print an internal text file in an
  312.           archive.
  313.      
  314.           V-Scan: start the process to open and virus scan an archive.
  315.      
  316.           M/V-Scan: start the process to open and virus scan a list of
  317.           archives in a given directory.
  318.      
  319.        In addition, there are two selections on the menu bar.  Choose
  320.        "Configure" to change the variable settings that were initially set
  321.        during installation.  This will start the AFE-CFG program which
  322.        should have been installed in the same directory as AFE.  The
  323.        interface for making the changes is similar to that of the
  324.        installation program.  When you are all done, or if you abort the
  325.        process, you will be returned to AFE.  More about the Config
  326.        program, later.
  327.      
  328.        "About" will display a window with product information and how to
  329.        contact the author.
  330.      
  331.      
  332.        2. Archive Submenu
  333.      
  334.        This is the menu you will see if you've started the program by
  335.        dragging and dropping an archive file on the AFE object (or double-
  336.        clicked an archive file), or if you're returning after viewing,
  337.        printing or virus scanning an archive.
  338.      
  339.        The choices are similar to the main menu, but at this stage you
  340.        already have the subject archive file opened and the archive's name
  341.        is displayed on the titlebar.
  342.      
  343.        From this point you can go immediately to choosing an internal file
  344.        to view, print or extract, run a virus scan, choose files to add to
  345.        (update) this archive, or go back to the main menu to initiate work
  346.        on another archive.
  347.      
  348.     15 January 1994                 Page 6                  AFE Version 2.2
  349.     -----------------------------------------------------------------------
  350.      
  351.        3. File Selection Window
  352.      
  353.        This same file selection window is used for many different file
  354.        selection operations.  THE KEY TO UNDERSTANDING WHAT YOU ARE BEING
  355.        SHOWN IS THE CAPTION DISPLAYED ON THE TITLEBAR.  More about this at
  356.        the appropriate times.
  357.      
  358.        File selection is done by clicking the left mouse button on the file
  359.        of choice to highlight it.  If this is a single file choice, then
  360.        double clicking has the same effect as pressing the "OK" button.
  361.        When a single file choice is appropriate, clicking on another
  362.        filename will unselect a previously selected file.  When a multifile
  363.        choice is apropriate, unselecting a file previously selected is
  364.        accomplished by clicking the highlighted filename.
  365.      
  366.        To change directories, doubleclick on the directory name desired in
  367.        the directories list.
  368.      
  369.        Changing to a different drive is accomplished by single-clicking the
  370.        down arrow alongside the displayed drive letter.  This reveals a
  371.        list of available drives on the system (or LAN).  Single click the
  372.        drive letter of choice.
  373.      
  374.        Note: the first time a particular drive is scanned, its directory
  375.        list is saved in a queue for the purpose of speedier list displays.
  376.        These directory lists are maintained until the system is rebooted.
  377.        The "Directory Reset on this Disk" pushbar is provided so that you
  378.        can update the directory list for the particular drive being
  379.        displayed should you add or delete a directory during the current
  380.        OS/2 session.
  381.      
  382.      
  383.        4. Creating a New Archive
  384.      
  385.        Pressing "Archive" from the main menu brings you to the
  386.        Create/Update submenu.  Pressing the "New" button enables the
  387.        archive type buttons.  After choosing the type of archive you want
  388.        to create, the filename window will become enabled for you to type
  389.        in the name of your new creation.  Note that the archive type may be
  390.        changed until you press "OK".  Also, if you decide that what you
  391.        really want to do is update an existing archive file, you need just
  392.        press "Existing" to cancel out the prior "New" selections.
  393.      
  394.        After pressing "OK" you will be shown the file selection window.
  395.        The default directory displayed is that which you selected as your
  396.        "PICK DIRECTORY" during installation/configuration.
  397.      
  398.        The titlebar caption reads "HIGHLIGHT FILE(S) TO ADD THEN OK, CANCEL
  399.        TO ABORT".
  400.      
  401.        If files are present in this directory, one of the pushbuttons below
  402.        filelist is labeled "All".  If the archive to be created will be
  403.        made up of all the files in this directory, simply press "All" to
  404.        start the archive process.
  405.      
  406.        If you wish to select individual files, highlight them (the "All"
  407.        button will change to "OK"), then press "OK".  This action creates a
  408.        special subdirectory where the chosen files are stored.  As each
  409.        file is copied, the highlight will be removed.  The "Cancel" button
  410.      
  411.     15 January 1994                 Page 7                  AFE Version 2.2
  412.     -----------------------------------------------------------------------
  413.        now changes to "Go".  If no other files are to be added, press "Go"
  414.        (or ESC) to create the archive.  If you wish to add other files
  415.        (perhaps from a different drive or directory), before pressing "Go",
  416.        highlight and "OK" those other files and press "Go" when all
  417.        selections are completed.
  418.      
  419.        The new archive is created in the directory you've designated as the
  420.        "ARC DIRECTORY" during installation/configuration.
  421.      
  422.        After the archive is created you are returned to the main menu.
  423.      
  424.      
  425.        5. Updating an Existing Archive
  426.      
  427.        The process is similar to creating a new archive as outlined above.
  428.        From the main menu, select "Archive".  From the Create/Update
  429.        submenu, choose "Existing".  You will then be presented with a file
  430.        selection window.  The default directory that is displayed is the
  431.        directory you've called your "ARC DIRECTORY" during
  432.        installation/configuration.
  433.      
  434.        The caption on the titlebar reads "HIGHLIGHT ARCHIVE TO UPDATE THEN
  435.        OK".  You choose the archive to be updated by highlighting the
  436.        filename and pressing "OK" or by double-clicking the filename.  You
  437.        can change drive/directory if the archive to be updated is 
  438.        elsewhere.
  439.      
  440.        After the selection is made the display will be updated to display
  441.        your "PICK DIRECTORY".  From here, the process is identical to that
  442.        outlined above for creating a new archive.
  443.      
  444.        From the Archive Submenu, choosing "Update" choosing "Extract" will
  445.        take you directly to the "PICK DIRECTORY" file selection window to
  446.        choose files to add.
  447.      
  448.      
  449.        6. UnArchive
  450.      
  451.        To extract files from an archive, "UnArchive" should be chosen from
  452.        the main menu.  This selection takes you to the file selection
  453.        window which lists the files found in the directory that you've
  454.        defined as the "ARC DIRECTORY".  The caption on the titlebar reads
  455.        "HIGHLIGHT ARCHIVE TO OPEN THEN OK".
  456.      
  457.        Select an archive from here, or you can change drive/directory and
  458.        select a file from somewhere else on the system.  Once the archive
  459.        is selected it will be opened and you will be taken to a file
  460.        selection window that displays a list of files within your archive.
  461.        The "current directory" window displays the name of the archive
  462.        file.  The caption on the titlebar reads "HIGHLIGHT FILES(S) TO
  463.        EXTRACT THEN OK".
  464.      
  465.        At this point, the "All" button is enabled to allow you to easilly
  466.        extract all the files in the archive.  Simply press "All" (or Enter)
  467.        to start the extraction process. If you choose to select specific
  468.        files, just highlight those.  When you do this, the "All" button
  469.        becomes the "OK" button.
  470.      
  471.        When all files are selected, push "OK" (or Enter).  If a single file
  472.        is what is desired, you can simply double-click that filename.
  473.      
  474.     15 January 1994                 Page 8                  AFE Version 2.2
  475.     -----------------------------------------------------------------------
  476.        However you have chosen to start the extraction, the selected files
  477.        are saved to your designated "UNARC DIRECTORY".  You are then
  478.        returned to the main menu.
  479.      
  480.        From the archive submenu, choosing "Extract" will take you directly
  481.        to the file selection window to choose the files to save from the
  482.        archive.
  483.      
  484.      
  485.        7. View or Print
  486.      
  487.        The file selection process for viewing or printing an archive's
  488.        internal file is the same, so both subjects will be discussed
  489.        together.
  490.      
  491.        When either are chosen from the main menu, you are taken to a file
  492.        selection window which displays a list of files in your designated
  493.        "ARC DIRECTORY".  The caption on the titlebar reads "HIGHLIGHT
  494.        ARCHIVE TO VIEW (or "PRINT") THEN OK".  You may select the desired
  495.        archive from here, or change drive or directory to choose an archive
  496.        from somewhere else.
  497.      
  498.        Open the archive file that contains the file that you wish to view
  499.        or print by either double-clicking the filename or selecting it and
  500.        pressing "OK" (or Enter).
  501.      
  502.        This takes you to another file selection window which lists the
  503.        files within the archive.  The caption on the titlebar reads
  504.        "HIGHLIGHT FILE TO VIEW (or "PRINT") THEN OK".  The name of the
  505.        archive file is shown in the current directory window.  Select the
  506.        desired file.
  507.      
  508.        In either "View" or "Print" mode, you are then returned to the
  509.        archive submenu.  If in "View" mode, the selected file is then
  510.        loaded into the program you've designated as "VIEWER EXECUTABLE".
  511.        If this file is a tagged .INF type file and you've opted to enable
  512.        an "INF EXECUTABE" in installation/configuration, then the file will
  513.        be loaded into that, instead.
  514.      
  515.        From this point you can perform other operations in AFE from the
  516.        archive submenu, or view and dismiss the file in the viewer.
  517.      
  518.        If in "Print" mode, the selected file is sent to the OS/2 print
  519.        spooler, and you may continue other operations in AFE.
  520.      
  521.        From the Archive submenu, select "View" or "Print".  This will take
  522.        you to the previously described file selection that will display the
  523.        internal file list for the currently opened archive.
  524.      
  525.        Operations from here are the same as described in the previous
  526.        section.
  527.      
  528.      
  529.        8. V-Scan
  530.      
  531.        Choose V-Scan when you want to virus scan a single archive file,
  532.        then do other operations on the chosen archive.
  533.      
  534.     15 January 1994                 Page 9                  AFE Version 2.2
  535.     -----------------------------------------------------------------------
  536.        The choice takes you to the now familiar file selection window which
  537.        displays all the files in the "ARC DIRECTORY".  You may choose a
  538.        file from here or change drive/directory to scan a different
  539.        archive.  The caption on the titlebar reads "HIGHLIGHT ARCHIVE TO
  540.        SCAN THEN OK".  Select an archive by double-clicking the filename or
  541.        highlighting it and pressing "OK" (or Enter).
  542.      
  543.        The archive is opened, then scanned.  If OS2SCAN finds no problems
  544.        with the files in the archive, then you are notified with a small
  545.        dialog that tells you so.  You may dismiss this dialog by pressing
  546.        "OK" (or Enter or ESC), and you're returned to the archive submenu,
  547.        from which you may perform other operations on this curently opened
  548.        archive.
  549.      
  550.        If a problem is detected, then you are notified with an alarm sound
  551.        and a generated report is displayed by the file viewer that you've
  552.        designated in the "VIEWER EXECUTABLE" variable.  This report gives
  553.        you the details of what OS2SCAN found.
  554.      
  555.        If you have not defined a "VIEWER EXECUTABLE" then you are notified
  556.        by the alarm, plus a small dialog is displayed which simply tells
  557.        you that a virus was detected.
  558.      
  559.        In either case, when a problem is detected, a report file named
  560.        VSCANRPT.### (where ### is a random number) will be left behind in
  561.        the "ARC DIRECTORY"
  562.      
  563.        When you choose this option from the archive submenu, virus scanning
  564.        is immediately started on the currently opened archive.  Operations
  565.        from that point on are the same as outlined in the previous section.
  566.      
  567.      
  568.        9. M/V-Scan
  569.      
  570.        Choose this option if there are several archives in a given
  571.        subdirectory which you wish to scan, or even if there is only one
  572.        archive to be scanned, but you wish to return directly to the main
  573.        menu after completing the scan (if you will have no other operations
  574.        to perform on the given archive).
  575.      
  576.        When you make this choice, a file selection dialog will be
  577.        displayed, listing the files in your "ARC DIRECTORY".  The caption
  578.        on the titlebar reads "HIGHLIGHT ARCHIVE(S) TO SCAN THEN OK".
  579.        Again, you may change drive/directory if desired.
  580.      
  581.        Select the archive(s) by highlighting each then pressing "OK" (or
  582.        Enter).
  583.      
  584.        Each archive is opened and scanned one at a time.  If no problem is
  585.        detected, a small dialog is displayed which notifies you of the
  586.        success.  After dismissing this dialog, the next previously selected
  587.        archive is opened and scanned.
  588.      
  589.        If a problem is detected by OS2SCAN, you are notified of the problem
  590.        the same way as with a single scan.  When you dismiss the virus
  591.        report from the viewer, or when you dismiss the dialog (in the
  592.        absence of a designated viewer), the next previously selected
  593.        archive is scanned.  Note that whether a virus is detected or not,
  594.        the temporary directory where the archive file is opened is removed
  595.        as soon as you dismiss the report or dialog, and a new
  596.      
  597.     15 January 1994                 Page 10                 AFE Version 2.2
  598.     -----------------------------------------------------------------------
  599.        temporary directory is established for the next archive.  If more
  600.        than one archive is found to have a problem, each will have its own
  601.        unique VSCANRPT.###.
  602.      
  603.        After the completion of all scans you are returned to the main menu.
  604.      
  605.      
  606.        10. Exiting AFE
  607.      
  608.        There are a few different ways to exit AFE.  From the main menu you
  609.        may simply press "EXIT" (or ESC).  You may also double-click the AFE
  610.        icon on the titlebar on either the main or archive submenu.
  611.      
  612.        AFE may also be exited from the the OS/2 window list as with any
  613.        other program.  Note that if you currently have an archive file
  614.        opened when you do this, the "cleanup" routine will not be performed
  615.        and AFE's temporary work directory will not be cleaned out and
  616.        removed.
  617.      
  618.      
  619.        11. Configure
  620.      
  621.        If you wish to change any of the variables that AFE uses, you should
  622.        select "Configure" from the menu bar on the main menu (mouse click
  623.        or Alt-C).  This starts AFE-CFG.EXE.  Note that AFE-CFG will only
  624.        run if started from AFE.
  625.      
  626.        The interface is similar to that of the installation program for the
  627.        variable selections, except that the default settings shown in the
  628.        entry fields are the current settings found in AFE.CFG.  For the
  629.        settings that you don't want to change, simply press "Okay" (or
  630.        Enter).
  631.      
  632.        Note that if you "Abort" at any time during the configuration
  633.        process, NO CHANGES THAT YOU MAY HAVE MADE WILL BE SAVED!!!
  634.      
  635.        When configure is completed  AFE restarts with the new settings
  636.        (provided you haven't modified the desktop object that AFE-INST
  637.        created in such a way that changed its WPS handle).
  638.      
  639.        While AFE.CFG is an ASCII file and may be modified with an editor,
  640.        this is NOT RECOMMENDED for two main reasons.  One, only the
  641.        variables themselves are in the file with no definitions.  It is
  642.        critical to AFE's successful performance that these variables are in
  643.        the correct order and the correct format, and that no extraneous
  644.        information is within the file.
  645.      
  646.        Secondly, the first time AFE is run, the AFE.CFG file settings are
  647.        stored in a queue so that subsequent startups of AFE do not require
  648.        reading AFE.CFG from disk.  When you run "Configure", this queue is
  649.        flushed and the new settings are read from disk when AFE is
  650.        restarted.  If you modify AFE.CFG another way, the settings do not
  651.        take effect until the system is rebooted.
  652.      
  653.      
  654.        12. Internal Archive Detection
  655.      
  656.        In the process of opening an archive (for unarchiving, viewing,
  657.        printing or virus scanning), AFE checks for other archives within it
  658.        (by examining the file extensions,looking for ZIP, LZH, ZOO or ARJ).
  659.      
  660.     15 January 1994                 Page 11                 AFE Version 2.2
  661.     -----------------------------------------------------------------------
  662.        If one or more is detected, the file selection dialog is displayed
  663.        listing only the archive files within the archive.  The caption on
  664.        the titlebar reads something like "ZIPFILES IN ARCHIVE, HIGHLIGHT
  665.        FILE(S) TO EXTRACT THEN OK", the first word depending on the type of
  666.        archive file found.
  667.      
  668.        You may, at this time, select any, all or none of these files to
  669.        unarchive along with the other files in the original archive.
  670.      
  671.        After the selection is made, you will proceed as normal.
  672.      
  673.      
  674.        13. Archive Errors
  675.      
  676.        AFE examines the exit codes of the various archive programs it
  677.        calls.  If an exit code is returned other than success, AFE reports
  678.        that the archive it tried to manipulate is errored or not an archive
  679.        file (of the ZIP, LZH, ZOO or ARJ type).
  680.      
  681.        Note that if you have defined the appropriate archiver executable
  682.        with the wrong program, it is possible that you will get this
  683.        dialog.
  684.      
  685.      
  686.        14. TryAll Subroutine
  687.      
  688.        If the archive you have chosen to open or update does not have an
  689.        extension of ZIP, LZH, ZOO or ARJ, AFE will still attempt to work
  690.        with it.
  691.      
  692.        The TryAll subrountine is called automatically and runs the "test"
  693.        mode of all (and only) the archivers you have defined in
  694.        configuration.  If it detects success from one of the archivers it
  695.        then calls the appropriate subroutine to open or update the archive.
  696.      
  697.        If it doesn't detect success from any of the defined archive
  698.        programs defined, it reports an error as outlined in the previous
  699.        section.
  700.      
  701.      
  702.        15. Variable Errors
  703.      
  704.        In many cases, where possible AFE disables the appropriate
  705.        capability if you do not define the corresponding executable.  For
  706.        example, if you do not define a program for the "ZIPPER EXECUTABLE"
  707.        the "ZIP" pushbutton on the archive create/update submenu is
  708.        disabled.
  709.      
  710.        If AFE detects that a program it wants to call doesn't exist, then
  711.        you are notified with an error message, which names the appropriate
  712.        variable in question.  A similar approach is taken with the paths
  713.        you've defined for your default directories.
  714.      
  715.        For example, if you have not defined a "ZIPPER EXECUTABLE" and then
  716.        try to update and existing ZIP file, you will be notified via the
  717.        above mentioned error message.
  718.      
  719.     15 January 1994                 Page 12                 AFE Version 2.2
  720.     -----------------------------------------------------------------------
  721.      
  722.        16. Miscellaneous Tips
  723.      
  724.        If you want to work with an existing archive, then start AFE by
  725.        dragging and dropping the archive file on the AFE desktop object.
  726.        You may also double-click the archive file (assuming that you
  727.        haven't removed the file associations in the AFE desktop object).
  728.      
  729.        Hitting ESC from any menu is equivalent to pushing the EXIT, CANCEL,
  730.        or equivalent, button.
  731.      
  732.        Hitting ENTER from any menu will "push" the button that the
  733.        "focus" is on.  The "focus" can be moved from button to button
  734.        with the tab key or cursor keys.
  735.      
  736.        When selecting files to include in an archive, make sure that you
  737.        highlight AND "OK" every file you want!  As mentioned above,
  738.        "Go" from this dialog will not add any more files to the list even
  739.        if files are highlighted.  Actually, there is a reminder of this on
  740.        the titlebar of the file selection dialog. If you have not yet
  741.        chosen any files, you'll be returned to the main menu.
  742.      
  743.        After completion of most operations, you are returned to the
  744.        secondary menu with the archive still open, ready for further
  745.        activity.  The two exceptions to this are completion of an
  746.        extraction operation, or completion of a create/update operation.
  747.        This design just made logical sense to me.
  748.      
  749.        You may change the relative location of all dialogs of AFE by
  750.        dragging the main menu to a different location.  For example, if you
  751.        want all dialogs to appear in the upper right corner of the screen,
  752.        drag the main menu there.  All subsequent dialogs will appear in the
  753.        upper right corner.  Note that the location is maintained only for
  754.        that particular session of AFE.  The default is to center all 
  755.        dialogs.
  756.      
  757.        If you have started AFE with multiple archive file "drops", the
  758.        submenu for each will be stacked upon each other.  "Peel" the layers
  759.        to address each archive.  Remember, the name of the archive will be
  760.        different on each titlebar.
  761.      
  762.        Note that while AFE supports multiple sessions, it is not
  763.        recommended that the program be started as outlined above, since the
  764.        various sessions will be competing with each other for the disk
  765.        drive and the net result will be that it takes longer to open all
  766.        the files "at the same time" than it would to drop individual
  767.        archives one at a time after the previous archive is already opened.
  768.      
  769.        Once AFE is running, you may still open additional sessions by
  770.        dragging another archive to the AFE desktop object.  If you started
  771.        AFE via an archive file drop, you can also start another AFE session
  772.        by double-clicking the desktop object.
  773.      
  774.        AFE should handle long filenames, filenames and archive file names
  775.        with spaces without fail.  This is assuming that you are running
  776.        OS/2's HPFS.
  777.      
  778.     15 January 1994                 Page 13                 AFE Version 2.2
  779.     -----------------------------------------------------------------------
  780.      
  781.     E. Cautions and Limitations
  782.      
  783.     The graphics for AFE were developed on an 800x600 desktop, and are
  784.     visually pleasing on 640x480, as well.  I've noticed that in 1024x768
  785.     mode that the buttons on the various menus are slightly offset.  If you
  786.     are a 1024x768 user, choose to register, and wish to have a version
  787.     that is more visually pleasing, make note of this on the registration
  788.     form and I will send you a 1024x768 version.
  789.      
  790.     When (DOS) ARJ is executed, it forces full screen mode. While I believe
  791.     there may be a workaround for this, it would cause extra work for the
  792.     user to configure AFE.  Since the OS/2 version of ARJ is in the works,
  793.     and the DOS version doesn't support HPFS style file names, I plan to 
  794.     I plan to wait for the OS/2 version.  Again, if registered users 
  795.     request a nearer term fix for this, I will work on it.
  796.  
  797.     When extracting files, if a file in your designated "UNARC DIRECTORY"
  798.     exists with the same name as a file being extracted, it will be
  799.     overwritten.
  800.      
  801.     If an archive file is detected within your archive (identified by
  802.     extension), you will be notified.  If you are going to virus scan,
  803.     choose the option to process this file so all of the internal files
  804.     are scanned.
  805.      
  806.     Archive within archive detection is carried out just one level deep.
  807.     To go any deeper, the code would have to be so convoluted that I didn't
  808.     think it was worth the effort.  If you are deeply concerned with the
  809.     possibility of something another level deep, you can look at the list
  810.     of files from the view or print selection.
  811.      
  812.     If you use a program like PSPM/2 or another "brute-force" type program
  813.     to close AFE, cleanup will not be performed. In addition, you run the
  814.     risk of "hanging-up" resources and not being able to use AFE again
  815.     without a system reboot.
  816.      
  817.     If you use the OS/2 window list to close AFE, the cleanup rountine will
  818.     not be run.  If you have an archive open at the time, AFE's temporary
  819.     directory will be left behind perhaps containing files from the
  820.     archive.
  821.      
  822.     AFE doesn't allow existing archives to create directories during
  823.     extraction, nor does it save path information in newly created
  824.     archives.
  825.      
  826.     AFE will open self extractors created by ZIP2EXE (DOS) from PKWARE and
  827.     LH2 (with MSE.CMD), but will not handle those made by LHA (DOS). It
  828.     will update ZIP2EXE created files, but has problems updating MSE 
  829.     created LZH files.
  830.      
  831.     AFE may exhibit problems with filenames with multiple periods in them
  832.     under certain circumstances due to a shortcoming of VX-Rexx.
  833.      
  834.     AFE was developed and tested under OS/2 2.1 GA.  For all I know it may
  835.     work with 2.0 or any of the 2.1 betas, but it has not been tested with
  836.     them.  Why would anyone want to run anything before 2.1 GA?
  837.      
  838.     15 January 1994                 Page 14                 AFE Version 2.2
  839.     -----------------------------------------------------------------------
  840.     4OS2 Users: If the VX-REXX "Console" window appears momentarily when
  841.     AFE calls one of the archivers or OS2SCAN, make sure you put @echo off
  842.     at the top of your 4START.CMD (or .BTM).  If the console still opens
  843.     and displays an output message from a program you call in 4START.CMD,
  844.     try a redirect to null ( >null) on the line that runs that program. If
  845.     the console displays a message like "INVALID VIO CALL", I believe this
  846.     is related to a combination of 4OS2 and certain drivers.  While any of
  847.     these displays are annoying, they should NOT effect the functioning of
  848.     AFE, or the program that is being run.
  849.  
  850.  
  851.      
  852.     F. Contacting the Author
  853.      
  854.     Please contact me with bug reports or other comments via email.  I have
  855.     spent many hours building and reworking this program, and would
  856.     appreciate any feedback, positive/negative.  There are several ways
  857.     to email me.  If you have internet access, send mail to:
  858.      
  859.        hmweine@pb1.pacbell.com
  860.      
  861.     If you have access to ILINK, send a message (in the OS/2 conference) to
  862.     "Howie Weiner".
  863.      
  864.     I log onto a few BBSes on an everyday basis.  You can leave mail to
  865.     "Howie Weiner" on ATT-PAC Auntie BBS in Dublin, Ca., (510)829-6062,
  866.     H-D-M Auntie BBS in Concord, Ca., (510)682-1371, or Sempervirens PC
  867.     Board BBS in Pittsburg, Ca., (510)432-7579.
  868.      
  869.     Note: ATT-PAC allows leaving messages on first logon.  Also, any new
  870.     releases of AFE will be posted there first!
  871.      
  872.     Both ATT-PAC and Sempervirens allow download of the AFE package on
  873.     first logon.  Thanks to SYSOPs Randy Young and Nancy Miller.
  874.           
  875.     15 January 1994                 Page 15                 AFE Version 2.2
  876.     -----------------------------------------------------------------------
  877.      
  878.     G.  Copyright Notices and Disclaimer
  879.      
  880.     AFE or Archive Front End is Copyright 1993, 1994 by H.M. Weiner
  881.      
  882.     OS/2 is a registered trademark of International Business Machine
  883.     (IBM) Corp.
  884.      
  885.     ZIP is copyright by Mark Adler, Richard B. Wales, Jean-loup Gailly, Kai
  886.     Uwe Rommel
  887.      
  888.     UNZIP is copyright by Info-ZIP, portions by S. H. Smith
  889.      
  890.     LHA is copyright by Haruyasu Yoshizaki
  891.      
  892.     ZIP2EXE is copyright by PKWARE
  893.      
  894.     LH2 is copyright by Peter Fitzsimmons
  895.      
  896.     ZOO is copyright by Rahul Dhesi
  897.      
  898.     ARJ is copyright by Robert Jung
  899.      
  900.     OS2SCAN is copyright by McAfee Associates
  901.      
  902.     VX-REXX is copyright by WATCOM
  903.      
  904.      
  905.     AFE IS PROVIDED AS IS AND COMES WITH NO WARRANTY OF ANY KIND, EITHER
  906.     EXPRESSED OR IMPLIED.  IN NO EVENT WILL THE AUTHOR BE LIABLE FOR
  907.     ANY DAMAGES RESULTING FROM THE USE OF THIS SOFTWARE.
  908.           
  909.     15 January 1994                 Page 16                 AFE Version 2.2
  910.     -----------------------------------------------------------------------
  911.      
  912.     H. What's New (AFE History)
  913.      
  914.     1.1 - 9/6/93 - First release of AFE, Freeware.  Written in REXX and
  915.     VREXX.
  916.      
  917.     2.0 - 10/15/93 - First Shareware release written in VX-REXX to get
  918.     around the limitations of VREXX.
  919.      
  920.     2.01 - 10/31/93 - If you tried to overwrite an archive that you started
  921.     AFE with by drag and drop, AFE would terminate soon after the program
  922.     deleted the original.  Still not quite sure why it did this
  923.     as this would not occur if you started AFE from the command line with
  924.     the file name as an argument, but probably something in the WPS.  Got
  925.     around this by changing the "Overwrite" button to "Update".  The
  926.     orginal archive is no longer deleted, but updated with the new files.
  927.      
  928.     When creating or updating an archive and the "PICKDIR" is empty, the
  929.     PICKDIR\* button is now disabled.
  930.      
  931.     When updating an existing archive and at the PICKDIR\* vs Select
  932.     submenu, somtimes a fully qualified filename would run off the title-
  933.     bar.  Added code to just display the filename, itself.
  934.      
  935.     When 4OS2 was used and the mode command was utilized in the
  936.     4START.CMD to set lines to something other than 25, the VX-REXX Console
  937.     opened with an error message when an external executable was called.
  938.     There was no problem with program function, just
  939.     cosmetically annoying.  Now fixed.
  940.      
  941.     I decided to spell "Copyright" correctly! (how embarrassing)
  942.      
  943.     2.2 - 1/15/94 - The file selection dialog is all new to accomodate
  944.     multifile selection, where appropriate.
  945.      
  946.     Mutliple archive V-Scan added by user request.
  947.      
  948.     AFE's temporary workdirectory is now named "\~AFETEMP.###" (###=random
  949.     number)
  950.      
  951.     When a virus is detected on a single scan, the main menu does not
  952.     appear until after the virus report is dismissed.  After the report
  953.     is dismissed on multiscans, the next selected archive (if any) is
  954.     scanned.
  955.      
  956.     Fixed a small problem that looks like it goes back to 2.01. When
  957.     archives are found within archives, a list is displayed by archive
  958.     type.  You were supposed to be able to select several or all (if there
  959.     was more than one) to unarchive.  What I found was that it only
  960.     unarchived the first selected. FIXED IT!
  961.      
  962.     Added support to view an internal .INF file with VIEW.EXE.
  963.      
  964.     Added support for (DOS version) ARJ.EXE per several user requests.
  965.      
  966.     Changed the layout of AFE.CFG to simplify it and provide a AFE-CFG
  967.     program to modify it that is called from AFE.
  968.      
  969.     Wrote a PM installation program.
  970.      
  971.     15 January 1994                 Page 17                 AFE Version 2.2
  972.     -----------------------------------------------------------------------
  973.     After the first time AFE.CFG is read from disk, it is stored in a QUEUE
  974.     so that it doesn't have to be read from disk the next time.  This QUEUE
  975.     stays active until the host system is rebooted or the user runs AFE-CFG
  976.     from AFE.
  977.      
  978.     QUEUE the directory list for each disk the first time a particular disk
  979.     is scanned for the file dialog.  This QUEUE stays active until the host
  980.     system is rebooted or the user presses the "Directory Reset" for the
  981.     particular disk being viewed.
  982.      
  983.     During the "cleanup" routine user is notified of progress via a banner
  984.     that says "PERFORMING HOUSEKEEPING ...".
  985.      
  986.     Corrected some display bugs with certain combinations of 4OS2 and video
  987.     drivers and UNZIP run under AFE.
  988.      
  989.     When more archive files are found within an archive, and the user is
  990.     presented with a list of those archive(s), the cancel button is now
  991.     changed to "None".
  992.      
  993.     Eliminated the printer window after the user chooses a file to print.
  994.     This was present only to remind the user to make sure the printer was
  995.     on and online before sending the file to the printer.  Since OS/2
  996.     manages the printer, this was probably unnecessary, so I eliminated it
  997.     to reduce program size.
  998.      
  999.     Combined the New vs. Existing window and the New Archive Name window.
  1000.     Put the choice of archive type on this window.
  1001.      
  1002.     Now, to create a new archive or update and existing one you press
  1003.     "Archive" from the main menu.  A secondary menu will be displayed, and
  1004.     if you want to update an existing file simply press "Existing" which
  1005.     will take you to the file menu.  If you press "New" then the archive
  1006.     type buttons will be enabled.  Select a type and then the name entry
  1007.     field will be enabled.  Until you hit OK, you can still change the
  1008.     archive type.
  1009.      
  1010.     Reworked the code that is accessed when an archive is opened for any
  1011.     reason and the archive doesn't have a proper extension.  Originally
  1012.     this routine was built for unarchiving only, and directly tried to
  1013.     unarchive.  Now that I'm also using this code to test for the type of
  1014.     archive when updating or creating, I've changed this to use the various
  1015.     archivers' "test" mode.  Once an errorlevel 0 is received the program
  1016.     jumps back to the appropriate routine for unarchiving or archiving
  1017.     depending on which test was passed.
  1018.      
  1019.     Added an "About" window to AFE.
  1020.      
  1021.     Removed closing copyright notice since there is now an "About" panel.
  1022.      
  1023.     Upgraded VX-REXX to 101b and c level.  New VROBJ.DLL (dated 11/19/93)
  1024.     required.
  1025.